   _____ _                    _            _
  /  ___| |                 _| |_        _| |_ 
 /  /   | |__   __ _ _ __ _|_   _|_ _ _ |_   _|
(  (    |  _ \ / _' | '__/ __| |/ _' | '__| | 
 \  \___| | | | (_) | | |__  | | (_) | |  | | 
  \_____|_| |_|\__,_|_| |___/|_|\__,_|_|  |_| 
 _____  _____ __  __           _ 
|  __ \/ __  |  \/  |         | |
| |  | \/ / /| \  / | ___   __| |
| |  | | / / | |\/| |/ _ \ / _  |
| |__| |/ /__| |  | | (_) | (_) |
|_____//_____|_|  |_|\___/ \____|
 ____  _             _       
|  _ \| |           (_)      
| (_) | |_   _  __ _ _ _ __  
|  __/| | | | |/ _` | | `_ \ 
| |   | | |_| | (_) | | | | |
|_|   |_|\__,_|\__, |_|_| |_|
                __/ |        
               |___/         

Version 1.1 - 27/4/5

This plugin is made for the D2Mod system, so you will need to have it installed in your Diablo II directory, or in your mod folder.

What does this plugin do?	

**New in v1.1!**
You can use the AddSkill Func that will let you give your starting character some skills. New heroes can now be experienced heroes :)

This plugin allows you to set stats or add to stats for a new character. You could give all your stating characters 100 gold, 5 stat points and 1 skill point to get them started on the right track, give specific bonuses to certain classes or preset some new stats that you have created and need to initialise.

>>-<_D2Mod Installation_>-<<
1) Insert this line into the [D2Mod] section of D2Mod.ini:

	CharStart=CharStart.dll

if you do not have this line already, add it as well

	NewTxt=NewTxt.dll

2) Put CharStart.dll in the same directory as the D2Mod ini file (either Diablo II directory or mod directory). Likewise if you do not have NewTxt.dll, place it in the same directory.

3) Put the CharStart.txt in your excel folder.

>>-<_Usage_>-<<

There are 4 files in this plugin.
CharStart.dll
Readme-CharStart1.1.txt
CharStart.txt
NewTxt.dll

>>-- IMPORTANT --<<

http://phrozenkeep.it-point.com/forum/viewtopic.php?t=19942&highlight=saved+stats

If you want to save your edited stats, you'll need to use the 'unused' lines in itemstatcost.txt. Please read this thread for more information.

>>-- CharStart.txt --<<

There are 6 Columns in CharStart.txt

Func	 - to choose the function of the row
  v1.1 has 3 Funcs - AddStat, SetStat and AddSkill
  Explanations below.

Class	 - to specify a class
  ama,sor,nec,pal,bar,dru,ass - similar to normal D2 class codes
  A blank Class column will enable the Func for all classes

ParamID	 - depends on Func
ParamVal - depends on Func
*remarks - a remark column for you to put notes
*eol	 - standard Blizzard style, please put a 0

-=-Funcs-=-

This will explain what the funcs are for, and how to set them up.

For the Stat-related Funcs, refer to ItemStatCost.txt for <ParamID>

Func: AddStat
AddStat adds the value in <ParamVal> to the stat in <ParamID>. The previous value is not checked.

Func: SetStat
SetStat sets the value of the stat in <ParamID> to <ParamVal>. The previous value is not checked. 

Func: AddSkill
AddSkill gives the player the skillID from

>>-<_Examples_>-<<

These examples follow the order of the columns in the file.
<Func> | <Class> | <ParamID> | <ParamVal>
Put the values in their appropriate columns.

Some common uses that you may like to use.

Addstat |     |  14 | 100  - Gives 100 gold to all characters
Addstat |     |   4 |   5  - Gives 5 Stat Points to all characters
Addstat |     |   5 |   1  - Gives 1 Skill Point to all characters

More good ones!

AddStat | sor |  39 |  20  - Starts the Sorceress with 20 Fire Resist
AddStat | nec |  45 |  25  - Starts the Necromancer with 25 Poison Resist
AddStat | pal | 109 |  50  - Starts the Paladin with 50% curse resistance

More radical ones that would depend on your storyline or preference.

SetStat |     |   6 | 256  - Sets the starting HP to 1 (maxHP is untouched). Good for a storyline where you've been bashed up ^_^
SetStat |     |  12 |   5  - Starts the character at Level 5. No bonuses to other stats. If your character is supposed to be a valiant knight or a mighty sorceress, it doesn't seem right to be a newbie at level 1!

Vampiric Class!

SetStat | nec |  74 |  -5  - Gives the Necromancer -5 HP Regen!
SetStat | nec |  60 |   5  - Gives the Necromancer +5 Lifesteal!

----

Okay I guess you can tell there're a lot of possibilities. I'll leave it to you, the modder, to play around with this!

>>-<_Version History_>-<<

v1.1	Fixed AddSkill! Kudos to Kingpin for helping me with this one. Added a bit more info about saved stats ( well actually just a link :) )

v1.0	Major overhaul of the plugin. Added txt support for the plugin, and no more values need to be entered in the ini file. The presence of a txt file means there's no limit to the number of entries you can have!

v0.9	First version of the plugin. Bonuses given through ini file, and limited in number, but a good start ;)

>>-<_To Do_>-<<

Joel suggested some Difficulty check so you can manipulate your character when he/she/it enters a difficulty for the first time. I think it sounds interesting, so I'll check it out when I've the time :)

If you've any other suggestions, post in the forum. PMing me is ok too, but in the forum I can ask for assistance if I've no idea how to go about it heh...

-------------

Thanks for trying this plug-in out. If there are any bugs or queries, PM me in the Keep.

Cheers,
RicFaith

Acknowledgements:
Kingpin - Man he gives me a lot of inspiration. He posted where to start looking.
Kingpin again - He solved the AddSkill display bug :)
Havvoric - NewTxt was rather tricky to get working... But since I got it working, I've no complaints! Thanks for taking the time to explain everything to me!
SVR - Because I'm waiting for D2Mod v1.3 ;)